home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d1 / blank17a.arc / BLANKS.DOC < prev    next >
Text File  |  1989-05-04  |  17KB  |  363 lines
  1.  
  2.                  ------------------------------------------- 
  3.                     For personal, non-commercial use only     
  4.                     All rights reserved - May not be sold
  5.                  ------------------------------------------- 
  6.  
  7.                  Copyright (C) 1988, 1989 by FM de Monasterio
  8.  
  9.                             BLANKs  version 1.6b
  10.                             --------------------
  11.  
  12.  
  13.          BLANKs is an MS-DOS/PC-DOS based, resident program that blanks the
  14.     screen after a preselected interval in the absence of a keypress.  This
  15.     interval can be selected from 1 to 60 minutes.  A selection higher than
  16.     60 minutes is set to 60.  Selecting 0 minutes disables screen blanking;
  17.     blanking can be enabled by re-invoking with an interval of 1 to 60 min.
  18.  
  19.     BLANKs is a terminate-and-stay resident (TSR) program.  When installed,
  20.     the program uses less than 1000 bytes.  It can be invoked repeatedly to
  21.     change its settings without producing multiple copies to memory. BLANKs
  22.     intercepts interrupts 8, 9 and 13h (and optionally 10h and 33h), and is
  23.     a "well behaved" TSR intended to run under MS-DOS or PC-DOS version 2.0
  24.     or higher.
  25.  
  26.  
  27.                              ----------------
  28.  
  29.     OPERATION:
  30.  
  31.        Screen blanking is obtained by direct commands to the hardware (video
  32.     controller) to turn off/on the video signal.  This is a fast method that
  33.     operates successfully in the IBM PC/XT, PC/AT and in some IBM compatible
  34.     computers installed with MDA, CGA, EGA, VGA, and Hercules video adapters
  35.     or with IBM compatible adapters from other manufacturers.
  36.  
  37.  
  38.      NOTICE   In some nonIBM microcomputers the program may not work and it
  39.      ------   should NOT be used with other video adapter types unless they
  40.               are compatible with the IBM adapter at the register level (as
  41.               it is possible that some of these adapters might be damaged).
  42.  
  43.  
  44.  
  45.        BLANKs intercepts interrupts 8h (hardware timer), 9h (keyboard), 10h
  46.     (BIOS video services), 13h (BIOS disk services) and 33h (mouse services
  47.     for device drivers following the Microsoft/Logitech Mouse format).
  48.  
  49.     BLANKs will fail to operate if access to interrupts 8 and 9 is denied by
  50.     another program or resident loaded after BLANKs. This might occur with a
  51.     few communication and some (older) word processing programs.
  52.  
  53.  
  54.   - Interrupt 8 is called 18.2 times/s to update the computer time-of-the-day
  55.     counter (which is stored in the BIOS data area).  Since a timer interrupt
  56.     can thus only operate within a period of about 55 ms or less (*including*
  57.     the overhead of DOS and other programs hooking on the timer), the program
  58.     uses direct commands to the hardware, written in assembly language, which
  59.     are issued, when needed, after the original timer interrupt is served.
  60.  
  61.   - Interrupt 9 is called when a key on the keyboard is pressed or released.
  62.     When the hotkey service is enabled (see switch /H below), BLANKs triggers
  63.     blanking of the screen when the default hotkey combination (CTRL-B in non
  64.     shareware versions) is pressed.  The hotkey code is then removed from the
  65.     keyboard buffer.  Other keys are passed along for keyboard processing and,
  66.     if blanking had occurred, the screen is restored.
  67.  
  68.   - Interrupt 10h is called to mediate a variety of video BIOS services. Since 
  69.     these services are comparatively slow, many programs make direct writes to
  70.     the screen (which are not detected by the resident part of BLANKs) instead
  71.     of using BIOS video calls.
  72.  
  73.   - Interrupt 13h is used to mediate a variety of hard disk and diskette BIOS
  74.     services. 
  75.  
  76.   - Interrupt 33h (which is not used by DOS or the BIOS) is used in Microsoft
  77.     and Logitech implementation of calls to the Mouse driver.  This interrupt
  78.     is claimed by the driver during its initialization.
  79.  
  80.  
  81.        NOTICE    To be able to monitor interrupt 33h, BLANKs must be installed
  82.        ------    *after* the mouse device driver, as otherwise the driver will
  83.                  not allow access to the interrupt.  Also note that the driver
  84.                  for a well known mouse can freeze the machine if interrupt 33
  85.                  is found to be in use at the time of installation.  This does
  86.                  not occur with other drivers, e.g. Logitech's MOUSE.COM.
  87.  
  88.  
  89.     BYPASSING INTERRUPTS:
  90.  
  91.     While installed, BLANKs bypasses the interrupt 8 when a blanking interval
  92.     of 0 minute has been selected (see below).   Interrupt 9 is bypassed only
  93.     when both an interval of 0 minute and the switch /H- (see below) have been
  94.     selected.  When /H- has been selected along with a nonzero interval, just
  95.     the hotkey service of interrupt 9 is bypassed.  Hence, these two interrupt
  96.     activities of BLANKs are bypassed by the "0 /H-" selection; this may be of
  97.     use in case of testing potential conflicts with other programs.
  98.  
  99.     Interrupts 10h and 33h are not intercepted when /K is selected; when this
  100.     switch is not selected, these two interrupts are intercepted but they are
  101.     not monitored unless switch /V is selected explicitly.
  102.  
  103.     Note that during cloning of the program, the status of switch /K is *not*
  104.     copied as a default setting to the clone, as monitoring of video activity
  105.     would otherwise be impossible irrespective of the status of switch /V.
  106.  
  107.  
  108.                              ----------------
  109.  
  110.    USAGE:
  111.  
  112.     From the DOS command line or from a batch file, BLANKs is installed (or,
  113.     when already installed, modified) by the command:
  114.     
  115.                            BLANKs [?] [min] [/switches]
  116.  
  117.  
  118.         [?]   Invokes a brief help and status display, identifying the type
  119.               of adapter for which the program is configured, the current
  120.               adapter, and program settings (if installed).
  121.  
  122.               Pressing key <F1> displays further help on using the program.
  123.               If the program has not been installed, pressing <F2> displays
  124.               the default settings of BLANKs.
  125.  
  126.  
  127.        [min]  Timed blanking interval in minutes. These are the minutes that
  128.               the program waits before blanking the screen in the absence of
  129.               keyboard activity.  Valid selections are 0 or a number in the
  130.               range of 1 to 60.  The selection of a 0-min interval disables
  131.               the timed blanking of the screen; the selection of an interval
  132.               larger than 60 defaults to 60 minutes for 2 digit inputs or to
  133.               the value (in the valid range) of the first 2 digits in inputs
  134.               containing larger numbers.    
  135.  
  136.               Null interval defaults to 3 minutes.  This value may be changed
  137.               by cloning the program (see below).
  138.  
  139.  
  140.  
  141.     Several switches are recognized.  While shown as being preceded by a "/"
  142.     for the sake of clarity, the program accepts any character between space
  143.     ( ) and slash (/) as a switch delimiter.  Invalid switches abort loading
  144.     of the program.  Switches are not case sensitive.
  145.  
  146.     NOTE:  Options marked with an asterisk (*) are available in the shareware
  147.            versions of BLANKs only.
  148.  
  149.  
  150.  
  151.         /U    Uninstall.   Use only when BLANKs was the last resident to be
  152.               installed, as otherwise this would create a "hole" in memory.
  153.  
  154.               The request is not honored if vectors to interrupts 8, 9 and
  155.               10h have been changed since installation. This can be caused
  156.               by a resident installed after BLANKs, or by a prior resident
  157.               that changes vectors set by programs installed after it. You
  158.               can determine if this is the case by using any of the memory
  159.               mapping programs that are available (search for interrupts 8
  160.               9 and 10; BLANKs.COM will be shown as an unnamed entry using
  161.               816 or 752 bytes, depending on the switch selection.) 
  162.  
  163.  
  164.  
  165.         /C    Clone to disk the current version of BLANKs installed in the
  166.               memory.(*)  This permits making the settings of this version
  167.               the default ones.
  168.  
  169.                    If the /C switch is entered in the command line alone,
  170.                    default parameters do not become effective (unlike the
  171.                    case of any other single switch specification) and the
  172.                    resident parameters are copied to the cloned file.
  173.  
  174.                    If other switches or parameters are entered along with
  175.                    /C, these new parameters and, when applicable, defaults
  176.                    become effective, and are copied to the cloned file.
  177.  
  178.               The clone file BLANKs.COM is written to the default drive and
  179.               directory. A warning is given if a file with the same name is
  180.               present there, and the user has the option to overwrite it or
  181.               to abort the cloning.  Cloning will not overwrite files other
  182.               than those with a normal or archive attribute, or both.
  183.  
  184.  
  185.  
  186.         /H    Hotkey switch.  In addition to timed screen blanking, BLANKs
  187.               allow for manual blanking of the screen by pressing a hotkey
  188.               combination.  This combination is CTRL-B in the nonshareware
  189.               version of the program (see below).  When BLANKs detects the
  190.               hotkey, it removes it from the keyboard buffer.  However, be
  191.               aware that programs loaded after BLANKs may save this input;
  192.               this is the case, for instance, with some word processors in
  193.               which it is necessary to erase the hotkey character from the
  194.               text.   In the shareware version, the hotkey combination can
  195.               be changed in case of assignment conflicts.
  196.  
  197.  
  198.               /H+  Enable hotkey operation.  This is the default condition
  199.                    when an argument is not specified for this switch.
  200.  
  201.  
  202.               /H-  Disable hotkey operation.  Can be reenabled with /H+.
  203.  
  204.  
  205.               /H?  Allow the selection of a new hotkey combination (*) that
  206.                    includes an alphanumeric key and one or more of the shift
  207.                    shift keys:  CTRL, ALT, left-SHIFT, and right-SHIFT.  For
  208.                    obvious reasons, CTRL or ALT, or both, must be included in
  209.                    the hotkey combination.
  210.  
  211.  
  212.  
  213.         /Ax   Force configuration to specified adapter.  This switch bypasses
  214.               the automatic configuration of the program for the video adapter
  215.               detected at the time of each calling.  Valid specifications for
  216.               this switch are:
  217.  
  218.               /Am   configuration for the IBM Monochrome Display Adapter (MDA)
  219.                     and Hercules graphics cards (HGA, HGA plus, and In Color);
  220.                     uses and restores bit 3 of the video port 3B8h.
  221.  
  222.               /Ac   configuration for the IBM Color Graphics Adapter (CGA), the
  223.                     Multi Color Graphics Array (MCGA) and compatibles; uses and
  224.                     restores bits 0-3 of port 3D9h and bit 3 of port 3D8h.
  225.  
  226.               /Ae   configuration for the IBM Enhanced Graphics Adapter (EGA)
  227.                     and compatibles; reads video ports 3BAh and 3DAh, and uses
  228.                     and restores bit 5 of port 3C0h.
  229.  
  230.               /Av   configuration for the Video Graphics Array (VGA); uses port
  231.                     3C4h, and uses and restores bit 5 of port 3C5h.
  232.  
  233.  
  234.               This configuration can be preserved as a default upon cloning of
  235.               (the shareware version of) BLANKs.  Switch /A is useful if video
  236.               adapter type were incorrectly identified or an "unknown" result
  237.               were obtained (see the Help display called by option "?").  See
  238.               the above NOTICE on compatibility.                          ---
  239.               ----------------------------------
  240.  
  241.  
  242.  
  243.         /V    Force monitoring of video activity mediated by BIOS and DOS calls
  244.               to interrupt 10h and by mouse calls to interrupt 33h. If enabled,
  245.               the switch avoids the timed blanking of the screen when the video
  246.               activity is detected; the switch, however, does not defeat manual
  247.               blanking of the screen, which can be unblanked only by keyboard
  248.               activity.  Its function is negated by switch /K.
  249.  
  250.               Note that the video output of some programs is not made through  
  251.               these interrupts and, hence, such activity will not be detected.
  252.  
  253.             Further, some mouse drivers can freeze the machine if interrupt
  254.               33h is found to be in use at the time of their initialization. 
  255.             If you have such a driver and do not want to install it before
  256.               BLANKs, you then need to install BLANKs with the /K switch, or
  257.               uninstall BLANKs before installing the mouse device driver and
  258.               then reinstall it with the /V switch.
  259.  
  260.  
  261.  
  262.  
  263.         /K    Force monitoring of keyboard activity only.  When enabled at the
  264.               time of the (first) installation, this switch installs a shorter
  265.               resident component of less than 800 bytes that disregards video
  266.               activity via interrupt 10h and 33h.  Because of the potential of
  267.               hanging the computer if a request to uninstall were made after a
  268.               change in the status of this switch, reinvocation of the program
  269.               ignores /K switch requests.  Hence, to change the status of this
  270.             switch, BLANKs must be uninstalled and then reinstalled.
  271.  
  272.             The status of the flag associated with the /K switch is ignored
  273.               during cloning, so that this switch cannot be set as a default.
  274.  
  275.  
  276.  
  277.         /P    Park the hard disk heads during manual or timed blanking of the
  278.             screen.  All physical hard disks attached to the disk controller
  279.             that can be accessed via the BIOS are parked (uses highest disk
  280.             cylinder).  Parking is suppressed if a BIOS disk(ette) service
  281.             is in progress at the time of blanking.
  282.  
  283.  
  284.               /P+  Enable hard disk parking.  This is the default condition
  285.                    when an argument is not specified for this switch.
  286.  
  287.               /P-  Disable disk parking.  Can be reenabled with /P[+].
  288.  
  289.  
  290.                                ----------------
  291.  
  292.     RELEASE:
  293.               The BLANKs utilities and the documentation (the "software")
  294.               are copyrighted by the author.  In the present nonshareware
  295.               form, they are distributed free of charge for NONCOMMERCIAL
  296.               PERSONAL USE ONLY.  
  297.  
  298.               Although the nonshareware version of BLANKs lacks a few of
  299.               the features noted above, it is a completely usable program.
  300.               No support is for this version.
  301.  
  302.  
  303.               The shareware versions of the programs cost $7 plus mailing,
  304.               and can be ordered from the address below (360 kb diskette).
  305.               Indicate whether an 80286 or an 8086 version is applicable;
  306.               the 80286 version does not check for CGA "snow."
  307.  
  308.  
  309.                                 ----------------
  310.  
  311.     LICENSE and INJUNCTIONS
  312.  
  313.           The copyright owner hereby licenses you, free of charge, to:
  314.  
  315.              1. Use this software for noncommercial, personal purposes.
  316.              2. Make as many copies of the software as desired.
  317.              3. Distribute the software including via electronic means.
  318.  
  319.  
  320.           The copyright owner hereby specifically prohibits you from:
  321.  
  322.              1. Charging or asking donations for copies of this software.
  323.              2. Distributing the software with commercial products without
  324.                 a written permission from the owner.
  325.              3. Distributing the software via a for-profit organization,
  326.                 either alone or with other software.
  327.  
  328.         Any other use is prohibited without express, written permission in
  329.         advance from the copyright owner.
  330.  
  331.  
  332.                                 ----------------
  333.  
  334.     DISCLAIMER:
  335.  
  336.               The author makes no warranty, either implied or expressed,
  337.               including, without limitation, any warranties with respect
  338.               to the software documented here, its quality, performance,
  339.               or fitness for any particular purpose.   In no event shall
  340.               the author be liable for damage, whether direct, indirect,
  341.               special, incidental, or consequential, that arise from the
  342.               use of or any defect in the software.   The entire risk as
  343.               to the quality and performance of the software is with the
  344.               user.  By using this program, you acknowledge: (1) to have
  345.               read and understood all parts of the disclaimer and (2) to
  346.               have agreed with and accepted all of its provisions.
  347.  
  348.  
  349.                                 ----------------
  350.  
  351.  
  352.               Refer all inquiries to:    F.M. de Monasterio
  353.                                          7013 Barkwater Ct.
  354.                                          Bethesda, Md 20817
  355.  
  356.  
  357.               Messages may be left at:   The DC Information Exchange BBS
  358.                                          202-433-6639
  359.                                          Sysop: Bill Walsh; 2400/1200 bps
  360.  
  361.  
  362.  
  363.